home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
system
/
dosmax21.zip
/
SHELLMAX.DOC
< prev
next >
Wrap
Text File
|
1993-06-01
|
11KB
|
287 lines
================================================================================
SHELLMAX.COM : Ver. 2.1, Copyright (1992,93) by Philip B. Gardner
================================================================================
SHELLMAX.COM is a utility which loads the primary shell high from the
SHELL= line in your CONFIG.SYS.
Support is provided for:
* Loading the primary SHELL into high memory
* Creating a primary SHELL stub in low memory
(improves compatability with some configurations)
================================================================================
(Requirements)::
* Requires MS-DOS Version 3.10 or better
================================================================================
(Installation)::
(CONFIG.SYS)::
Installation of SHELLMAX.COM requires modifying the contents of
your CONFIG.SYS file.
SHELL=SHELLMAX.COM [options] COMMAND.COM /P
Insert SHELLMAX.COM in your SHELL= line of your CONFIG.SYS.
SHELLMAX.
(Safety)::
When installing SHELLMAX, it is best if you copy SHELLMAX.COM and
COMMAND.COM (the primary shell), to the root directory of your boot
drive. If SHELLMAX fails to function properly with the parameters
in your SHELL= command line, it will issue a series of error messages,
and then try and load COMMAND.COM from the root directory. This will
give you a chance to edit the CONFIG.SYS and correct the problem.
You should exercise caution and have a boot floppy available.
SHELLMAX is compatible with full SHELL= command line specifications.
In the following example, neither SHELLMAX.COM or COMMAND.COM is
required in the root directory after installation is successful, as
indicated by no error or warning messages.
SHELL=C:\BOOT\SHELLMAX.COM /R- C:\DOS\COMMAND.COM C:\DOS /E:512 /P
All switch options and possible messages for SHELLMAX are detailed
below:
================================================================================
(Compatibility)::
(4DOS)::
If you are using Version 4.x 4DOS from J.P. Software, you should
add the path to 4DOS.COM to the 4DOS command line.
SHELL=SHELLMAX.COM C:\4DOS\4DOS.COM C:\4DOS /p
If this parameter is not added, 4DOS may not set the environment
variable "COMSPEC=" properly.
(DOS 3.x & 4.x)::
Some versions of DOS incorrectly truncate the command line to 35
characters for the SHELL= statement in the CONFIG.SYS or fail to
pass a command line at all if the line is over 35 characters.
This bug is circumvented by a special algorithum in SHELLMAX. If
SHELLMAX does not work for you, and you suspect that this is the
problem, please contact me for assistance.
================================================================================
(Syntax)::
The only thing to remember about syntax for the command line is
that just about anything works. What this means is that you
should be able to type in the options on the command line the
way they make sense to you.
To illustrate this point, the following command line example
is mutated several different ways.
SHELL=SHELLMAX.COM /R- /P+ /S+ C:\COMMAND.COM C:\ /P
SHELL=SHELLMAX.COM -R- -P+ -S+ C:\COMMAND.COM C:\ /P
SHELL=SHELLMAX.COM /R-/P+/S+ C:\COMMAND.COM C:\ /P
SHELL=SHELLMAX.COM -R--P+-S+ C:\COMMAND.COM C:\ /P
... and so on.
SHELLMAX 2.0 and above adds optional full word syntax. The new
syntax looks like this:
SHELL=SHELLMAX.COM /REPORT:- /PAUSE:+ /FAKESTUB:+ C:\COMMAND.COM C:\ /P
SHELL=SHELLMAX.COM -REPORT:- -PAUSE:+ -FAKESTUB:+ C:\COMMAND.COM C:\ /P
SHELL=SHELLMAX.COM /REPORT:-/PAUSE:+/FAKESTUB:+ C:\COMMAND.COM C:\ /P
SHELL=SHELLMAX.COM -REPORT:--PAUSE:+-FAKESTUB:+ C:\COMMAND.COM C:\ /P
Obviously when using full words, it is easier to keep the words
separated so that is clear to read. The optional [:] is used
for toggle switches (i.e. REPORT:+). These optional delimiters
can also be used with the single letter switches. Exact spelling
is required because the single letter interface is still intact.
(Switch Options)::
The following list of switch options is organized by:
- Control of SHELLMAX Reports (/R:/P:/N:)
- Control the Configuration of a Fake Low Memory Stub (/S:)
- Response file for SHELLMAX (@)
(Control of SHELLMAX Reports)::
(REPORT):: R[+ or -] (toggle: default +)
Use /R- or /REPORT:- to disable the report after you are
satisfied with the configuration of STOPMAX.SYS
(PAUSE):: P[+ or -] (toggle: default +)
Use /P- or /PAUSE:- to disable the pause after the report as
long as there are no errors or warnings.
(NOPAUSE):: N[+ or -] (toggle: default -)
Use /N+ or /NOPAUSE:+ to never pause after the report, even if
there are errors. This switch can be used if your configuration
generates a warning or error message which you choose to ignore.
(Control the Configuration of a Fake Low Memory Stub)
(FAKESTUB):: S[+ or -] (toggle: default -)
If you use SHELLMAX to load the shell high, then some programs
(environment editors and some networks), are confused that no
portion of the primary shell is is low memory. Use /S+ or
/FAKESTUB:+ to tell SHELLMAX to create a fake stub, which looks
like the primary shell, in low memory. This stub tracks changes
to the Master Environment segment pointer by monitoring the real
stub high (each "get exit code of sub-program" INT 21h, 4Dh).
The stub size is 256 bytes, so if you use 4DOS, and find that
you need the low stub, it is better to just let 4DOS do it and
not use SHELLMAX.
(Response file for SHELLMAX)::
Parameters for SHELLMAX may be read from a response file by using the
@pathname syntax:
SHELLMAX.COM @RESPONSE.FIL C:\COMMAND.COM C:\ /E:512 /P
Notice that the path to the SHELL is cannot be in the response file.
Response files may be commented by using a ";","#",or "*" character
before the comment.
* everything in square brackets "[]" is optional
(CONFIG.SYS Line)::
SHELL=SHELLMAX.COM [/R-/P+/N+/S+] COMMAND.COM /P
default: /R+/P-/N-/S-
* Report status messages
* Don't Pause after report
* Pause on errors or warnings
* Don't Fake stub low
================================================================================
(Report Format)::
SHELLMAX.COM (8086): Ver. 2.1, Copyright (1992,93) by Philip B. Gardner
ERROR : (Error Messages)
WARNING : (Warning Messages)
ADVICE : (Advisory Messages)
: (Report Messages)
: (Allocation Status)
PAUSE : Press any key to continue...
================================================================================
(Error Messages)::
MS-DOS version 3.10 or above is required
Bad or missing program specification
Use SHELLMAX.COM only as CONFIG.SYS SHELL=
Not enough memory to execute
Fatal Error, program halted
================================================================================
(Warning Messages)::
Unknown option in command line
Unknown option on line #0000
Extra characters on command line
Missing or invalid option file XXXXXXXX.XXX
Line length overflow at line #0000
Unable to load high, loading low
====================